MOD HAVEN DDS STUDIO
FiveM textures made easy.

STUDENT QUICK START
===================

Mod Haven DDS Studio is a portable Windows app. Nothing needs to be installed.

BEFORE YOU OPEN IT
------------------
1. Download the ZIP.
2. Right-click the ZIP and choose Extract All.
3. Open the extracted folder.
4. Keep these files together in the same folder:
   - Mod Haven DDS Studio.exe
   - texconv.exe
5. Double-click Mod Haven DDS Studio.exe.

IMPORTANT: Do not run the app from inside the ZIP. Extract the folder first.

If Windows SmartScreen appears, click More info, then Run anyway.

HOW TO USE DDS STUDIO
---------------------
1. Drag texture files or an entire texture folder into DDS Studio.
2. Review the detected texture type.
3. Change the texture type only if DDS Studio guessed incorrectly.
4. Leave Resolution on Keep Original unless you specifically want to resize that texture.
5. Leave DDS Compression on Auto (Recommended) for normal FiveM use.
6. Choose where you want the finished DDS files saved.
7. Click CONVERT TO DDS.

SUPPORTED INPUTS
----------------
PNG
JPG / JPEG
TGA
BMP
DDS

AUTOMATIC DDS COMPRESSION
-------------------------
Auto (Recommended) chooses the FiveM-friendly format automatically:
- Opaque / no transparency -> DXT1 / BC1
- Transparency / alpha -> DXT5 / BC3

You can manually choose DXT1 / BC1 or DXT5 / BC3 if needed.

Mipmaps are generated automatically during conversion.

TEXTURE TYPES
-------------
DDS Studio can identify common filename tags for:
- Diffuse
- Normal
- Specular
- Emissive

If a texture is Unclassified, you can still convert it. Just choose the correct type manually if needed.

BATCH TOOLS
-----------
Use the checkboxes beside textures to select multiple files at once.

For selected textures you can apply:
- Texture Type
- Size / Resolution
- Alpha setting

Use Remove only when you want to remove selected textures from the current batch. It does not delete your original files.

OUTPUT OPTIONS
--------------
DDS Output folder:
Creates a DDS Output folder beside the source texture.

Same folder:
Saves the DDS beside the original texture.

Choose folder:
Lets you choose a specific destination folder.

IF FILE EXISTS
--------------
Create a Copy:
Keeps the existing DDS and creates a new copy with a different filename.

Replace Existing:
Replaces the existing DDS with the new conversion.

Skip Existing:
Leaves the existing DDS alone and skips that file.

PREVIEWS
--------
PNG, JPG and BMP previews appear directly.

DDS and TGA previews are generated when you click the texture, so the first preview may take a moment. This keeps large batch loading fast.

After converting a texture, use Original / DDS Result to compare the source texture with the converted DDS preview.

TROUBLESHOOTING
---------------
"DDS engine missing":
texconv.exe is missing or was moved. Put texconv.exe back in the same folder as Mod Haven DDS Studio.exe.

App will not open from the ZIP:
Extract the ZIP first, then open the EXE from the extracted folder.

Windows warns about the app:
Because this is a portable Mod Haven student tool and is not distributed through the Microsoft Store, Windows may show SmartScreen. Click More info -> Run anyway if you downloaded the file directly from Mod Haven.

Need help?
Use the Mod Haven student support area / Discord and include a screenshot of the issue.

DO NOT DELETE texconv.exe.
DDS Studio needs it to create and preview DDS textures.

© Mod Haven. Student resource.